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FIG. 4A 



// 

// Http Request Servlet 

// public class RequestServiet extends HttpServlet { 



void service(HttpServietRequest request, HttpServletResponse response) throws 

ServletException, lOException { 

// get an device format adapter that recognizes and handle this request 

// format from a Http Device Format Manager 

// the request can come from a browser or a mobile device or 

// any other source that conforms to the Http protocol 

400 HttpAdapter adapter = HttpDeviceFormatManager.getAdapter(requestresponse); 

// ask the adapter to convert the process the request 
// the adapter convert the request to a RequestObject recognized by the 
// web controller and invoke the processRequestQ method on the web 
// controller 

402 adapter. processRequestQ; 

} 



} 
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// 

// DeviceFormatAdapter 

// - defines the basic interface that defines a device format adater 
// interface DeviceFormatAdapter { 

// returns a device format id 
getDeviceFormatld(): 
// returns the device type 
getDeviceTypeQ; 

// returns a adapter specific session context 
getSessionContexl(); 

} 
// 

// HttpAdapter 

// - defines a Http specific device format adapter 

// 

interface HttpAdapter extends DeviceFormatAdapter { 
// return a the HttpServietRequest 
getRequest(); 

\ v 

// returns the input parameters 
getRequestPropertiesQ: 

// process request 
processRequestO; 

} 
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// HttpAdapterBaselmpI FIG 4B(il) 

abstract class HttpAdapterBaselmpI implements HttpAdapter { 

HttpServletRequest req; 
HttpServletResponse res; 

HttpAdapterBaselmpl(HtipServletRequest req, HttpServletResponse res) 

// construct new instance of the adapter and initialize it with the request 
// and response 

} 

createRequestObjectQ ; 

// build a RequestObject based on the request information 

} 

processRequestQ { 

// convert from HttpServletRequest into I RequestObject 
RequestObject reqobj = createRequestObject(); 

// pass request object and response object to web controller 
HttpWebController.processRequest(reqobj, res); 

} 

getRequest() { 
return req; ) 

} ,v. 
Typed Property getRequestProperties() { 

// extract request properties from request and put in in a TypedProperty 

} ; " 

} ' 

II 

II HttpBrowserAdapter 

// 

public class HttpBrowserAdapter extends HttpAdapterBaselmpI { 

SessionContext getSessionContextQ { 

// return an Http Browser specific session context 

} 



HttpPVCAdapter 

public class HttpPVCAdapter extends HttpAdapterBaselmpI implement HttpAdapler } 



SessionContext getSessionContext() { 
// return a PVC specific session context 
} 

} 
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FIG. 4C(i) 



// 

// RequestObject - defines the request object that is passed to the web controller 
// from any network device 

// each adapter can have add adapter specific extension to this 

// for example. The Http Adapter adds the HttpServletRequest to this interface 

// 

interface RequestObject { 

// return the adapter used to format the incoming request 
getDeviceFormatAdapterO ; 
// returns the input properties for the command 
getRequestProperties() ; 
// returns the session context 

getSessionContext(); ) 404 

II sets the adapter used to process this request 
setDeviceFormatAdapter(); 
// set the input properties 
setRequestPropertiesO ; 
// sets the session context 
setSessionContext(); 
// gets the command name 
get CommandNameO; 

} 

// CornmandContext - defines the information that can be accessible to the 
// command and the web controller to process a command 

II 

interface CommandContextO { 

// returns the device type 
getDeviceTypeO; 

// returns the input properties for the command 
getRequestPropertiesQ ; 
// returns the store Id 
getStoreld(); 

// returns the user id ) 406 

getUserldO; 

// returns the command name 
setCommandNameO; 
setUserldO; 

// return the adapter used to format the incoming request 
getAdapterQ; 



} 
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FIG. 4C(ii) 

// processRequest 

// This is the main processing unit of the web controller 

// It is responsible for the execution of a command within a transaction ,i 

II 

processRequest(RequestObject req, ResponseObject res) { 

//create a command context object based on the input request 
CommandContext commandContext = createCommandContext(req,res); 
try{ 

// beginTransaction(); 

// set session data in command context 

retrieveSessionData(commandContext); 

// look up and instantiate command to be executed 
ECCommand command = prepareRequest(commandContext); 

// set input properties for command 

command.setRequestProperties(commandContext, 

getRequestPropertiesQ); 

// set commandContext for command 
command.setCommandContextO; 

// execute command 
command.executeO; 

// update session data based on info from command context 
updateSessionData(commandContext); 

// retrieve response properties from command 
responseProperties = command.getResponseProperties(); 

//get a response view 

command viewCommand = prepareResponse(responseProperties, commandContext); 

// execute the view command 

if (viewCommand != null) { 

viewCommand.execute(); 
} 

commitTransactionO 
} catch (Exfception e) { 

// rollbackTransaction(); 

// 

handleError(e,commandContext); 
} 

} 

} 
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// WebController is the abstract base class the handles any implementation that is 
// common for all web controllers 

// 



abstract class WebController { 

CommandContext createCommandContext(RequestObj req, ResponseObject res) 
// save request object and response object in command context 
// also extract request parameters, request name, adapter type 

} 

ViewEntry getViewEntry(String commandName, CommandContext commandContext) { 
// look up view based on view name, storeld and device type 



UrIEntry getUrlEntry(String commandName, CommandContext commandContext) { 
// look up url entry based on command name and storeld 

ECCommand instantiateCommand(ViewEntry viewEntry, CommandContext 41 0 
commandContext) 

// instantiate command based on interface for view command, store id 

} 

ECCommand instantiateCommand(UrlEntry urlEntry, CommandContext 41 0 
commandContext) { 
// instantiate command based on command interface, store id 
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// HttpWebController handles any implementation that is specific to the Http protocol 

// 

public static class HttpWebController { 

ECCommand prepareRequest(CommandContext) throws Exception { 
// look up url entry from URLREG based on name and store id 

UrIEntry urIEntry =getUrlEntry(commandContext.getCommandNameO,oommandContext); 

if (urIEntry == null) { 

// look up view based on view name, storeld and device type 
ViewEntry viewEntry = 

getViewEntry(commandContext.getCommandName() l commandContext); 
command = instantiateCommand(viewEntry,commandContext); 

} else { 

// check for https redirection 

if (urlEntry.isHttps() && (!commandContext.isHttps()) { 

ViewEntry viewEntry = getViewEntry("HttpsRedirectView M , commandContext); 

// instantiate command based on interface for view command, store id 
command = instantiateCommand(viewEntry, commandContext); 

} else { 

// instantiate command based on command interface, store id 
command = instantiateCommand(urlEntry,commandContext); 

} 

} 

return command; 

// 

// prepareResponse 

// 

ECCommand prepareResponse(TypedProperty responseProperties, 
CommandContext 

commandContext)throws Exception { 
// return view command; 

} 

retrieveSessionData(CommandContext commandContext) { 

// retrieve session data from session context and set it in command context 

} 

updateSessionData(CommandContext commandContext) { 

// retrieve session data from command context and set it in session context 

} 

} 
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FIG. 4C(v) 



// 

// TypedProperty - an extended Hashtable that is used passed request and 
// response information to and from a command 

// 

class TypedProperty extends Hashtable { 



String getString(String parameterName) { 

// return the values of a parameter as a String 

} 

String getlnteger(String parameterName) { 

// returns the value of a parameter as an Integer 

} 

StringQ getStringArray(String parameterName) { 

// return the values of a parameter as an array of String 

} 

putParameter(String parameterName, Object parameterValue) { 
// store the parameterValue against a parameterName 

} 



} 
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FIG. 6A 

// 

//The MQ Adapter listens for incoming messages from the network 

// 

public class MQSerialAdapter { 

// 

serviceLoop() { 

while (true) { 

// get a message from the queue 
MQMessage msg = getRequestFromQueue(); 

// create an adapter to transform and process this message 
XmlAdapter adapter = createAdapter(MQMessage msg); 
adapter.processRequest(); 

} 

} 



public class XmlAdapter implements DeviceFormatAdapter { 

processRequestO { 

// convert from message from xml format into a 
// RequestObject 

RequestObject reqobj = createRequestObject(job); 

// 

XMLWebController.processRequest(reqobj, job); 



} 
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XMLWebController handles any implementation that is specific to the MQAdapter 



public class XMLWebController extends WebController { 

ECCommand prepareRequest(CommandContext commandContext) 
throws Exception { 

// look up url entry from URLREG based on command name and storeld 
UrIEntry urIEntry = getUrlEntry(getCommandName(),commandContext); 

// instantiate command based on command interface, store id 
command = instantiateCommand(urlEntry,commandContext); 

// 

return command; 

} 

ECCommand prepareResponse() throws Exception { 
// MQ don't need any response view 
return null; 

} 

retrieveSessionData(CommandContext commandContext) { 
// noop - MQ don't have session info 

} 

updateSessionData(CommandContext commandContext) { 
// noop - MQ don't have session info 

} 
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// 

// Scheduler 

// The scheduler runs background jobs. They can be jobs that is to be executed only 
// once at a specified time or can be jobs that are to be run at regular intervals. 
// Jobs are added to the database with the request information, a preferred start time, 
// user id and or frequency intervals. 

// Job can be added from the browser or from another command 

// 



,F ;: - 



Si 



public class Scheduler { 

// 

serviceLoop() { 

while (true) { 



// sleep time is determined by the start time of next job 
sleepUntilNextJoblsToBeRun(); 

// retrieve the job that need to be executed now from the 
// database 

SchedulerJob job = getReadyToRunJob(); 

// allocate a thread to run the job 

SchedulerThread thread = getThreadToRunJobOob); 

// start the thread 
thread. start(); 



} 

} 
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// SchedulerThread 

public class SchedulerThread { 
SchedulerJob job; 
run() { 

service(job); 

} 

service(SchedulerJob job) { 

// create a scheduler adapter to process the job 
SchedulerAdapter adapter = createSchedulerAdapter(job); 
Uk adapter.processRequest(); 

O } 
P } 

s 11 

gj II SchedulerAdapter 

il // The scheduler adapter is responsible for converting a scheduler job into a request object 

^ // and pass on to the SchedulerWebController 

« // 

y public class Scheduler Adapter implements DeviceFormatAdapter { 
processRequest () 

// convert from scheduler job info into a RequestObject 
RequestObject reqobj = createRequestObject(job); 

// pass request to SchedulerWebController to process 
SchedulerWebController.processRequest(reqobj, job); 
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SchedulerWebController handles any implementation that is specific to the scheduler 



public static class SchedulerWebController extends WebController { 
ECCommand prepareRequest(CommandContext commandContext) 
throws Exception { 

// look up url entry from URLREG based on command name and storeld 
UrIEntry urIEntry = 

getUrlEntry(getCommandName(),commandContext); 

// instantiate command based on command interface, store id 
command = instantiateCommand(urlEntry,commandContext); 

// 

updateDatabasef jobStarted"); 

return command; 

ECCommand prepareResponse() throws Exception { 

// update scheduler database 
updateDatabase(" jobCompleted"); 
// a background job do not return a view 
return null; 

} 

retrieveSessionData(CommandContext commandContext) { 
// noop - scheduler don't have session info 

} 

updateSessionData(CommandContext commandContext) { 
// noop - scheduler don't have session info 

} 

} 
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